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public static final int NONE 
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1206 

FIG. 1 2D / 
/** ' 

* Given a list of class names, apply each validation rule of the classes 

* to input string and return the formatted result. 
* 

* ©return the viewable formatted string. 

* ©param classNames a comma-separated fully qualified list of concrete AbstractRule classes. 

* ©param input the input string to apply edit rules to. 

* ©exception ValidatonRuleException if there was an error in applying the edits. 
V 

public static String applyEdits(String classNames, String input) throws ValidationRuleException { 
int commalndex = -1; 
int curlndex = 0; 
do j 

commalndex=classNames.indexOf( , t \ curlndex); 
if (commalndex == -1) j 

commalndex = classNames. Iength(); 

String className = classNames.substring(curlndex, commalndex).trim(); 
try | 

ValidationRule rule = (ValidationRule) Factory.newInstonce(className); 

input = rule.edit(input); 
} catch (ValidationRuleException re) { 

throw re; 
| catch (Exception e) { 

throw new ValidationRuleException("Rule class "' + classNome + not found."); 

i 

curlndex = commalndex + 1; 
j while (curlndex < clossNames.length()); 
return input; 
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s 

AoplicationMediotor ImpI.exitO : AUS8- 1999-0694 
/•• 

* Exit the ApplicotionMediotor by exiting oil allocated ViewControllers 

* and ApplicationMediators. All data is set to null, and lists are 

* destroyed. An 'exited' ApplicotionMediotor cannot be used ogain. 

* If this method is overriden in a subclass, be sure to invoke 

* super.exit(); 

••/ 

public void exit() { 

synchronized (this) j 

/* Used for style 1 event dispatching. Leave this code commented. */ 
//if (this.eventThread !=null) [ 
// try { 

// eventThread.stop (); 

// | catch (Exception e) { 

'/* 

/* Used for style 2 event dispatching. Leave this code commented. */ 
for (int i = 0; i < runningThreads.sizeQ; j 

((ApplicationMediatorThread) runningThreads.elementAt (i)) .stop(); 

runningThreads.removeAIIEIements(); 
viewListeners.removeAIIEIements(); 
try \ 

for (int i = 0; i < viewControllers.size(); | 

ffViewController} viewControllers.elementAt(i)) .setEnabled(false); 
((ViewController) viewControllers.elementAt(i)) .exit (); 

for (int i = 0; i < applicationMediators.size(); \ 

(fApplicationMediator) applicationMediators.elementAtfi|) .setEnabled(false); 
((ApplicotionMediotor) applicationMediators.elementAt(i)) .exit(); 

catch (Exception noProblem) | 



viewControllers = null; 
applicotionMediators = null; 
runningThreods = null; 
runningThreads = null; 
data = null; 



FIG. 1 7F 
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ApplicotionMediotorlmDl.cleQrO : AUS8- 1999-0694 
/** 

* Clear the ApplicationMediator by clearing all allocated ViewControllers 

* and ApplicationMediators. All data is set to null, but lists are 

* not destroyed. A 'cleared 1 ApplicationMediator can be used again. 

* If this methed is overriden in a subclass, be sure to invoke 

* super.clear(); 

v 

public void clear() \ 

synchronized (this) { 

/* Used for style 1 event dispatching. Leave this code commented. */ 
//if (this.eventthread != null) j 
// try \ 

I / eventThread.stop (); 

// \ catch (Exception e) j 

0. 1 

/* Used for style 2 event dispatching. Leave this code commented. */ 
for (int i = 0; i < runningThreads.size(); j 

((ApplicationMediatorThread) runningThreads.elementAt (i)) .stop(); 

runningThreads.removeAIIEIements(); 
try | 

for (int i = 0; i < viewControllers.size(); i++) { 

ffViewController} viewControllers.elementAt(i)) .setEnabled(false); 
((ViewController) viewControllers.elementAt(i)) .clear (); 

for (int i = 0; i < applicationMediators.size(); | 

^ApplicationMediator^ applicationMediators.elementAtfi)) .setEnabled(false); 
((ApplicationMediator) applicationMediators.elementAt(ij) .clearQ; 

| catch (Exception noRealProblem) { 

viewControllers = null; 
applicationMediators = null; 
data = null; 

viewListeners.removeAIIEIements(); 

1 FIG. 1 7G 
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/** 

* Initolize the ApplicotionMediotor using the listeners of on 

* existing ApplicotionMediotor. 
*/ 

public void init(ApplicotionMediotor opplicotionMediotor) { 

if (opplicotionMediotor instonceof ApplicotionMediotorlmpI) j 

ApplicotionMediatorlmpI o = (ApplicationMediotorlmpQ opplicotionMediotor; 
requestListeners = (Vector) o.requestListeners.clone(); 
placementListeners = (Vector) a.placementListeners.clone(); 
topListeners = (Vector) o.topListeners.clone(); 
addViewListener(o); 



initQ; 



FIG. 1 7H 



1712 

/ 

/** 

* When new data arrives allow the ViewControllers 

* and ApplicotionControllers to be refreshed also. 

v 

public void refresh(Object data) J 
this.data = doto; 
try { 

synchronized (viewControllers) { 

for (int j = 0; j < viewControllers.sizeQ; j++) } 

((ViewController) viewControllers.elementAt(j)). 
refresh(doto); 

catch (Exception noRealProblem) j 



try | 

synchronized (opplicotionMediotors) j 

for (int j = 0; j < applicationMediators.size(); j++) | 
((ApplicotionMediotor) opplicotionMediotors. 
elementAt(j)).refresh(data); 

I catch (Exception noRealProblem) { 



FIG. 1 71 
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/ 

/*• 

* A ViewEvent is delivered. Process it using Threading style 1 or 2. In 

* the end, the processViewEvent will be colled on the subclass. 

♦/ 

public void viewEventPerformed (ViewEvent e) { 

/* Used for style 2 event dispatching, start an inner class thread */ 
ApplicationMediatorThread t = new ApplicationMediatorThread (e); 
runningThreads.addElement (t); 
t.start (); 

/* Used for style 1 event dispatching. Leave this code commented. */ 

//ViewEvent saved = saveViewEvent(e); 

//if (eventThread == null | | !eventThread.isAlive()) { 

// finished = false; 

// eventThread = new Thread(this); 

// eventThread.start (); 

//synchronized (this) J 
notify(); 

1 FIG. 1 7 J 



1714 

/** 

* This method is used in style 1 threoding. Rename this to run () 

* and uncomment the code os described in the closs jovodoc. 
•/ 

public final void run2 () } 

/* Used for style 1 event dispatching. Leave this code commented. */ 

A 

while (true) | 

ViewEvent event = null; 
event = getViewEvent (); 
if (event != null) j 

handleViewEvent (event); 
( else { 

waitForEvent (); 

if (finished) j 

// something went wrong with the thread so hose this loop 
break; 

i 



FIG. 1 7K 
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/ 

/** 

* Private closs to handle executions of ViewEvents () on another thread. 

**/ 

private class ApplicationMediatorThread extends Thread j 

/- 

* The current event 

••/ 

private ViewEvent event; 

/** 

* Create an ApplicationMediatorThread to process the ViewEvent 

••/ 

public ApplicationMediatorThread(ViewEvent event) j 
super (); 

this.event = event; 

\- 

* Just call the handleViewEvent method that the subclass will override 

public void run () j 

processViewEvent (event); 



FIG. 1 7L 



1714 

I" 

* Save the current ViewEvent on a Q 

*/ 

private final ViewEvent saveViewEvent (ViewEvent e) j 

/* Used for style 1 event dispatching. Leave this code commented. */ 
//return viewEventQueue.add(e); 
return null; 

i 

/** 

* Method: return the first view event saved. Used by the Q'mg system. 

*/ 

private ViewEvent getViewEvent () { 

/* Used for style 1 event dispatching. Leave this code commented. */ 
//return (ViewEvent) viewEventQueue.remove(); 
return null; 

' FIG. 1 7M 
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Tronsporter.requestEventPerformed(RequestEvent) :AllS8- 1 999-0693 

/•• 

* Submit o synchronous request. For each Destination that is listening for 

* the current family of RequestEvents (the major code), send the RequestEvent 

* to the Destination for processing. If there is a problem, throw 

* a RequestException. Continue processing the RequestEvent as long 

* as a RequestException is not thrown by a Destination and the RequestEvent 

* is not consumed. 

* <p> 

* If tagging is enabled, then append a status tag to the RequestEvent. 
*<p> 

* Destinations are processed in the following FIFO order: 

* 1- All using "!" (priority). 

* 2- All using a major code. 

* 3- All using 
*<p> 

* ©exception RequestException if the Request can't be submitted 

*/ 

public void requestEventPerformed(RequestEvent request) throws RequestException j 
if (lenabled) | 

throw new RequestException("Transporter disabled"); 

I 

/* Try to tag the request */ X 
if (tagging) v 2606 
request.setStatus(request.getStatus() + "[Transporter] 11 ); 

/* Process PRIORITY, major and then WILDCARD destinations */ 
processDestinationsf request, getDestinations(PRIORITY)); 
processDestinationsfrequest, getDestinations(request.getMajor())); 
processDestinations(request, getDestinations(WILDCARD)); 



FIG. 26 F 



I 



** 



* Submit an asynchronous request. See the synchronous 

* requestEventPerformed for more information. 

public void requestEventPerformed(RequestEvent request, 
RequestResponseListener caller) throws RequestException { 
if (lenabled) } 

throw new RequestException("Transporter disabled"); 

if (tagging) 

request. setStatus(request.getStatus() + 

"[Transporter async.]"); "*" x -2608 

//start an inner class thread 

TransporterThread t = new TransporterThread(request ( caller); 

runninqThreads.put(request, t); 

t.startQ; 

' FIG. 26G 
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2610 
/ 

Tronsporter.TronsporterThreod :AUS8- 1 999-0693 

A* 

* Private class to handle executions of submits() on another 
thread. 

private class TransporterThread extends Thread \ 

A* 

* The current request 

A* 

private RequestEvent request; 

A* 

* The caller of submit that we will call back 

••/ 

private RequestResponseListener caller; 



A* 

* Create a transporter thread 

public TransporterThread(RequestEvent request, 
RequestResponseListener caller) { 
super(); 

this. request = request; 
this.caller = caller; 

* Just call the synchronous version of 
requestEventPerformed() 

**/ 

public void run() { 
try | 

requestEventPerformed(request); 

caller.requestResponse(request); 
j catch (RequestException yikes); | 

caller.requestException(yikes); 
( finally \ 

runningThrecds.remove(request); 

1 FIG. 26 H 
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RemoteDestinotion.requestEventPerformed(RequestEvent) ^US8- 1 999-0704 
/** 

* Process request event. 

* <P>PRE: None 

* <P>POST: None 
* 

* ©porom request the RequestEvent object to be processed. 

* ©exception RequestException if there was on error during the 

* processing of the event. 

•/ 

public void requestEventPerformed(RequestEvent request) throws 
RequestException { 
try { 

Method method = null; 
if (session == null) { 

// get home interface. 
Context ctxt = get!nitialContext(); 
Object home = ctxt.lookup(request.getMojor() + 



"SessionHome"); 



method = home.getClassO.getMethodC'create", null); 
session = method.invoke(home, null); 



//get method on home object and invoke it. 

method = session.getClass().getMethod(request.getMinor() f 

new Closs[] fObject.classj); 
request.setDatc(method.invoke(session ( new Object[] 
|request.getData()()); 

if (request.getMinor().equals( ,, remove")) j 
session = null; 

\ catch (InvocationTargetException te) { 

throw new RequestException(te.getTargetException()); 
| catch (Throwable t) { 

throw new RequestException(t); 

, r v 

2806 

FIG. 28D 



Factory 

Voriobles 



Name 


Declaration 


Description 


.copyright 


public static final String_copyright 


(c) International Business Machines Inc., 
1997 1998 1999. All rights reserved. 



FIG. 29 A 2900 
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View Controller 
C START ) 



Select screen 



Creote class 



Override init() method 
replace with code to 
creote, initialize and 
layout graphical 
components 



Override 
refreshQ method 



Override 
clearQ method 



Add view controller 
as components 
event listener 



Implement 
event listeners 



Use validation 
rules to validate 
user input 



Create and fire 
ViewEvents 



C END ) 

FIG. 31 



Create Validation Rule 
( START } 



Choose business 
validation rule 



Create closs 



Override edit() 
method 



Override 
normalizeQ method 



•3200 



■3202 



-3204 



•3206 




3210 



Create a ViewEvent 
C START ) 



Create interface to 
ViewEvent codes 
in application 

i 



■3300 



Creote instonce 
of ViewEvent 



Send ViewEvent 

FIG. 33 



■3302 
■3304 
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3400- 
3402- 
3404- 
3406- 

3408- 

3410- 
3412- 



Creote 
ApplicotionMediotor 

( START ) 



Choose function 



Create class 



Override initQ method 



Create ViewControllers 



i 



Override process 
ViewEventQ method 



Create RequestEvents 



Involve refresh 



C END ) 

FIG. 34 



Creote RequestEvent 
( START ) 



Create interface 
to contain strings 
of major and minor 
codes of RequestEvents 



Create instance 
of RequestEvent 



Send event using fire 
RequestEventQ method 



( END ) 

FIG. 35 



Create a Destination 
C START ) 



Choose destination 



Create class 



Override initQ method 



i 



Override 
requestEventPerformed() 
method 



i 



Override 
concelQ method 



Override 
finolize() method 



C END ) 

FIG. 36 



3500 



3502 



-3504 



-3600 
3602 
•3604 

•3606 

•3608 
•3610 
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3700^ 

3702- 
3704- 

3706- 
3708- 



Create TopListener 
( START ) 

Create class that 
contains or is in the top 

frame of opplicotion 
and implements interface 



Create exitQ method 



i 



Create launchQ 
method 



Create message() 
method 



Create titleQ method 



( END ) 

FIG. 37 



Create 
PlacementListener 

( START ) 

Creole type 
of placement 

Create class 
implementing 

PlacementListener 
interface 



i 



Implement 
placement method 

i 

FIG. 38 



■3800 



■3802 



■3804 
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Basic Operation of a ViewControllerlmpI 



4000- 

4002- 
4004- 
4006- 

4008- 
4010- 



4012- 



( START ) 



Implement 
the ViewController 
Interface 



Implement 
the JTC Interface 



Add specific methods 



Create and 
compose the GUI 

i 



Return "yourself" 
in getComponent 



Return permission 
keys, resources and 
properties when asked 



Update permission 
keys, resources and 
properties when asked 

— i 



FIG. 40 









Handle internal 
AWT events 


^4014 








Validote and 
format data fields 


^4016 








Issue ViewEvents for 
semantic interpretation 


^-4018 








Return the AWT 
thread immediately 


^4020 








Handle refresh calls 
to update the GUI 


"^4022 


1 






Access the dota 


^-4024 


/^StiN^^ YES 





^octive?, 
4026 I N0 
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4100- 



4104- 

4106- 
4108- 

41 10- 



41 14- 



4116- 



4118- 



4120- 



( START ) 



ApplicotionMediotor 
receives ViewEvent 
from ViewController 




Create PlocementEvent 
with proper majorCode 



Fire PlocementEvent 



Invoke PlacementListener 



PlacementListener 

receives 
PlocementEvent 




Call toHTML() on 
ViewController component 



Translate View 
components into 
HTML components 



Create and place 
OtherAlternateView 



■4124 



Generate HTML output 



Send HTML output to 
client Browser for display 



( END ) 



FIG. 41 
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I 



ViewEvent and ViewListener Usage 

—►Usage from a ViewController 

public void actionPerformed(ActionEvent e) { 
if (e.getSource() == nextButton) { 

ViewEvent ve = new ViewEvent (this); 
ve.setMajor(ViewEvent.NEXT); 
fireViewEvent(ve); //notify 
ViewEvent listener 
return; 



FIG. 42 



—►Usage from ViewListener (i.e. ApplicationMediator) 
//add myself as a listener 
customerDetailsViewController.oddViewListener(this); 

//later, we are called back on this method to handle the 
ViewEvent 

processViewEvent (ViewEvent event) j 
//do something 
switch (event.getMajorQ) j 

case ViewEvent.NEXT: //... 

break; 

case ViewEvent.OK: //... 
break; 



FIG. 43 



i 
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ValidationRules Usage 

Example Choining 
//each rule 

String range = ,, com.xyz.jtc.RangeChecker , ; 
String money = "com.xyz.jtc.AccountMoney"; 

//build the chain of rules 
String[] rules = {range, money|; 

//get the value to validate 
String value = textField.getText(); 

try 1 , . s 

value = applyEdits(rules, input); 
catch (ValidationRuleException ouch) | 

//the value is validated and formatted, redisplay 
textField.setText(value); 

FIG. 47 

ViewControllerBoselmpI 

For example: 

♦ inheritance 

public class ViewControllerBoselmpI extends JPanel | 
public Component getComponent() { 
return this; 

1 FIG. 48 

♦ delegation 

public class ViewControllerBoselmpI implements ViewController 

XYZ xyz = new XYZ(); 

public javo.owt.Component getComponent() { 
return xyz; 

public void setEnabled(boolean e) { 
xyz.setEnabled(e); 

public void setVisible(boolean v) { 
xyz.setVisible(v); 

FIG. 49 
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5200^ 


Implement 
ApplicotionMediotor Interfoce 








5202-^ 


Implement JTC Interfoce 






u 


5204-^ 


Add 

ApplicotionMediotorlmpI methods 








JiUU ^ — 


Creote ViewControllers 
using initViewControllers 








5208^ 


Use InitApplicationMediotor 

to creote other 
ApplicotionMediotors 
as necessary 
















5210^ 


Listen for ViewEvents 
and RequestEvents 






ViewEvent^^ NO 




^.received? ^S 0 ^ 




5212 ^ 


YES 


5214^ 


Request PlacementListener 

to put another 
ViewController on screen 








5216^ 


Have TopListener do desktop 
operations as appropriate 








5218^ 


Fire appropriate 
requestEvents to servers 






V 


5220^ 


Send refresh calls to 
ViewControllers and 
ApplicotionMediotors 








5222-^ 


Return all JTC 
objects allocated 











FIG. 52 

Design Steps for 
an ApplicationMediator 
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"click" 

J L 

AWTEvent 



C 



Placement runtime 



IS 



C 



VolidationRules 



ViewController 



(<] | o > t> o I (&] 



5302 
5308 



J 



— Validatii 



ValidationRuleException 



5304 

ViewEvent > 5306 



ViewEvent ^ 



PlacementListener 



, DJUO y—\ s ; — ; ; \ 

I J f daja J K ApplicationMediotor j 



□ 



\<\ I > o t> I 0 



PlacementEvent 



5310- 



< 



> 



extends 



subclass 



> 



FIG. 53 



Placement example 

Usage from ApplicationMediotor 
//in an ApplicationMediotor 
int major = PlacementEventADD; 
Component component = 
customerDetailsViewController.getComponent(); 
PlacementEvent e = new PlacementEvent(this, component, major); 
firePlacementEvent(e); 

FIG. 54 



Usage from PlocementListener 

public class MyProgram implements PlacementListener { 

public void plocementEventPerformed(PlacementEvent e) \ 
//decide based on source type 
switch (e.getMajor()) { 

case PlacementEventADD: 

if (e.getSourceQ instanceof PreferencesAm) 
panel Laddf Center" , e.getComponent()); 

else panel2.odd( I, A n l e.getComponent()); 
break; 

case PlacementEventREMOVE: 
//do something else 

break; 

i 

//etc. 



FIG. 55 
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5600- 



5602- 



5604- 



5606- 



( START ) 



ViewControllers respond 
to getComponent() 

i 



ApplicotionMediotors control 
ordering of ViewControllers 



FIG. 56 

Design Steps for 
a PlacementEvent 



ApplicotionMediotors 
fire PlocementEvents 



PlacementListeners select the 
proper implementotion ond place 
the Component on the screen 



5700 



TopListener runtime 



•click" 



<^ AWTEvent ^ 





r iui i i 






1 — 1 
1 - 1 

1 1 





c 



VolidationRules 



ViewController 



VolidotionRuleException 



1 



PlacementListener 



0 1 > > > > 1 0 



^ ViewEvent ^ 

c 




5706 



DATA 



ApplicationMediator 




PlacementEvent 



~— ' _ — . LL 

(BO fil 



SkqjLJl'^ < ^TopEvent^ 
^TopListener^* ^ 



extends 



5= 



.St 



■ ■ ■ i« — 



5702 



<^ subclass^ 




lounch 



exit 



FIG. 57 



desktop 



browser 



reconfigure 
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Transporter 

—►This class implements the JTC and RequestEventListener interfaces 
— ► Its primary function is to mop RequestEvents to Destinations. 

♦ Typically ApplicationMediators fire RequestEvents and Destinations process 
them 

—►Add o Transporter to an ApplicationMediator to listen for RequestEvents 

Transporter t = new Transported); 
ApplicationMediator am = new ApplicationMediator(); 
am.addRequestListener(t); 

—►The ApplicationMediator will fire RequestEvents 

RequestEvent r = new RequestEvent(source, major, minor, data); 
try | 

fireRequestEvent(r); 
catch (RequestException yikes) {( 

FIG. 67 
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Destination 

RequestEvents ore identified by 

♦ major code - represents a family of Requests 

♦ minor code - represents a specific Request 

Destinations are added to the Transporter as DestinationListeners 

specifing a major code for RequestEvents they are interested in receiving 
The destination is called when the major code of the RequestEvent 
matches the destination major code 



EJBDestination d = new EJBDestination(); 
Transporter t = new Transported); 
String major = "Loans"; 
t.addDestinationListener(major ( d); 



Multiple Destinations can listen for the same RequestEvent major code 

♦ processed FIFO/FESP (first in first out, first exception stop forwarding) 

• results of one Destination can be passed to the next Destination 

FIG. 69 



Destinations and major codes 

Special major codes 

♦ wildcard 

■ "*" major code indicates the Destination is interested in all and any RequestEvents 

■ processed after specific major codes have been matched. 

♦ priority 

■ "!" major code indicates the Destination is interested in all requests and should be given 
priority. 

■ processing performed before specific major codes and wildcards 
For example 

Transporter t = new Transported); 
t.addDestinationListener ("*", new WildDestination ()); 
t.addDestinationListener ("Loans", new EJBDestination()); 
t.addDestinationListener ("I", new PriorityDestination()); 

//later 

RequestEvent r = new RequestEvent(this ( "Loans", " ", null); 
try | 

fireRequestEvent(r); 
catch (RequestException yikes) \\ 

♦ The RequestEvent "r" will be sent to PriorityDestination 1st, EJBDestination 2nd, 
and WildDestination() 3rd, assuming no RequestExceptions are thrown. 

FIG. 70 
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( START ) 



Call getJTCs 
ond get Vector 
of JTC objects 



7500 




7506- 



YES 



Use entry(i) 



Listen 
for events 
ond debug, 
log, trace, 
simulote 




( RETURN ) 



7524 



7514 

"Is 
instanceof 
ViewController^ 

7516" 




Add os 
RequestListner 

""V 

7522 



hookAWts with 
Component 



Add as 
RequestListener 



hookAWts with 
Component 



7518 



•7510 



7512 



FIG. 75 
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7600- 



7602 







t 




A1 




A2 




A3 



FIG. 76 



7606 









7604, r 






7608-^ 


A11 


A12 




A31 




A32 






/ 

7610 




S 

7612 





7614 



hookAWTs with 
Component XYZ 




7702- 



Get list of 
Components in 
Container XYZ 




7706- 



Use 
Component(i) 



7708 




Hook 
the Component 
XYZ 



7714 



( RETURN ) 



Hook 
the Component(i) 

1 



7710 



FIG. 77 
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Data Objects 

v/The ApplicotionMediotorlmpI will forword the refresh (defoult) 



for^eoch: ApplicotionMediotor -> refresh(dato) 
for^each: ViewController -> refresh(data); 

FIG. 79 



v/The ViewController will update the GUI 

public void refresh(Object data) j 
//this example uses o keyValue pair data model 

if (data == null) return; 
else refresh((KeyValue) data); 

public void refresh (KeyValue data) j 

nameField.setText(data.get( ,, CustomerName ,, )); 
idField.setText(data.get( <, Customerld ,, )); 
repoint(); //if necessary 

L 1 FIG. 80 



Data Objects 

i/How can we add a new data model (i.e. real objects)? 

public void refresh(Object data) { 
if (data == null) return; 
else if (data instanceof Vector) { 
refresh((Vector) data); 

else if (data instanceof KeyValue) | 
refresh((KeyValue) data); 

1 FIG. 81 



public void refresh(Vector data) } 
//I know what they are 
Customer c = (Customer) dota.elementAt(O); 
ID id = (ID) data.elementAt(l); 
nameField.setText(c.getName()); 
idField.setText(id.toString()); 
repaint(); //if necessary 

' FIG. 82 



79/119 
AUS990339US5 



More on data 



8304 



ApplicotionMediotor ^ 



property 
change 




8302 



async streaming 



c 



8300 



ViewController 



1. Named methods 
public double get CustomerName() 

2. Implicit data model and ViewEvent 
ve.setData("Mr. Chips"); 
fireViewEvent(ve); 

3. Explicit data model and ViewEvent 
data.putO'LASTNAME", "Chips"); 
ve.setData(data); 
fireViewEvent(ve); 

4. Property Change events 
dota.put("S0LUTION", "JTC"); 



FIG. 83 



80/119 
AUS990339US5 



8400- 



8404- 

8406- 
8408- 
8410 



( START ) 



ApplicotionMediotor receives 
ViewEvent from ViewController 




Create TopEvent with 
proper mojorCode 



Fire TopEvent 



i 



Invoke Set of TopListeners 



TopListener receives TopEvent 




8414 



Exit 

the application 



8418 



Display message 
for application 



8422 



Display title 
for application 



FIG. 84 



8426 



Execute other 
application 



C END ) 
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8500- 



8504- 

8506- 
8508- 

8510- 



( START ) 



ApplicationMediator 

receives ViewEvent 
from ViewController 




Create 
PlocementEvent with 
proper major code. 



Fire PlocementEvent 



Invoke 
PlocementListener 



PlacementListener 
receives PlocementEvent 




8514 



Add ViewController's 
component to a visual 
container and repaint. 



8518 



Remove ViewController's 
component from a visual 
container and repaint. 



( END ) 



FIG. 85 
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Handling AWTEvents 



Apply 
ValidotionRules 

8616 




FIG. 86 



8632- 



Error message 



( RETURN ) 
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I 



Applying VolidationRules fireViewEvent 
( START ) ( START ) 




J 

( RETURN ) 



FIG. 87 



Application Manager 
( START ) 



8900- 



8902- 



Create 
ViewControllers 



Respond 
to Events 



( END ) 

FIG. 89 



Application Manager 
C START ) 



Data Event 



For Each 
ViewController Coll 
Refresh (Doto) 

C END ) 

FIG. 90 
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I 



9100- 



9102 



9104 



Application Manager 
( START ) 



Add Listener 



Find 
Listener Type 



Add Listener 
Type to Vector 



( END ) 

FIG. 91 



Application Manager 
( START ) 



Remove Listener 



Find 
Listener Type 



Remove Listener 
From Vector 



C END ) 

FIG. 92 



■9200 



-9202 



-9204 



Application Manager 
C START ) 



9300- 



I 



9302- 



Get/Set 
Permission 



Process 
Permission 



( END ) 

FIG. 93 
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Application Manager 
( START ) 



ViewEvent 



Process ViewEvent 



-9400 
-9402 




Known? 
9406 i yes 



Default 



Handle the Specific 
Request (Doto) 



9410 



( END ) 

FIG. 94 



85/119 
AUS990339US5 



CD 

cn 
o 



o 
o 

~t5_ 
<C 






ent 




q3 


c 




^> 


O) 


~o 


LU 


c= 


t_ 


~cr 


o 


"c 


cd 


Ql 


o 


E 


E 


o 


CD 


o 




o 


o 


CD 


Plo 


CZ 


E 


a? 


US 


o 









ate 
vent 




"E= 

CD §> 


<D 

O O 




•— u_i 

Ll_ Q_ 
O 

1 — 


\ 

OJ 


s 

^* 






lO 




CD 


CD 



5: 




86/119 
AUS990339US5 



9600- 
9602- 

9604- 

9606-. 



9610- 



9612- 



refresh(Object dato) 
in ApplicationMediator 

( START ) 



Refresh Object data 



Access data 



For each 
ApplicationMediator(i) 



ApplicationMediator(iVrefresh 
(Object data) 




For each 
ViewControlIer(i) 



ViewController(i). refresh 
(Object data) 




9614 i no 
C RETURN ) 

FIG. 96 



( START ) 




( RETURN ) 

FIG. 98 
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refresh(Object data) 
in ViewController 



( START ) 




9700 



NO r 


YES 




Cost 


data 




into recognized 




type T 



I 



Coll refresh for 

type T os in 
refresh (T data) 



Update 
locale state 



Update GUI 



< RETURN ) 



9720 



Ignore or 
generate error 



9712 

•9714 

9716 
9718 



FIG. 97 
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9900 

9902 
9904- 
9906- 
9908- 

9910- 
9912- 

9914- 
9916- 

9918- 



9936- 



9938- 



C START ") 



Create Top 
ApplicationMediator 



i 



Add TopListeners 



i 



Add RequestListeners 



Add PlacementListeners 



Add ViewListeners 



Create 2nd Level 
ApplicationMediator 



i 



Clone TopListeners 



i 



Clone RequestListeners 



Clone PlacementListeners 



Add Top 
ApplicationMediator 
as the ViewListener 




Create ViewController 



Add parent Level 
ApplicationMediator 
os the ViewListener 



FIG. 99 




Create 3rd Level 
ApplicationMediator 



Clone TopListeners 



Clone RequestListeners 



Clone PlacementListeners 



Add Upper Level 
ApplicationMediator 
os the ViewList ener 

1 



C END ) 



■9926 



-9928 



-9930 



-9932 



9934 
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( START ) 



10000- 



10002- 



10004- 



Receive user 
oction input 



Creote ond fire 
component event 



ViewControIler receives 
component event 



10006 




10008- 



10010- 



ViewController creates 
ond fires ViewEvent 



VC's parent 
ApplicationMediator 
receives ViewEvent 




10018- 



10020- 



Refire ViewEvent 



AM's parent 
ApplicationMediator 
receives ViewEvent 



FIG. 1 0O 



( START ) 



Load confiq file of 
ApplicationMediator 
state stanzas 



Build a multi- 
dimensional List of 
the config file 



Process events 
and calls 



( RETURN ) 

FIG. 1 0 1 
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Encoding ApplicationMediators 

SI: (VE.source==vc1 && VE.major==A && VE.minor==B) => 
(RE.major=C RE.minor=D RE.dato=VE.doto RE.fireS) 

if event source is vc1 with A,B as major/minor then 

fire sync request with C,D major/minor and use data from event) 

S2: VE.source==vc4 && VE. major ==5) = = > (TE.major=3 TE.fire) 
if event source is vc4 with 5 os major then 
fire top event with major 3 

S3: (Refresh) ==> (VC.i.refresh(Refresh.data)) 

if refresh(data) occurs, then refresh all view controllers with the 
same data, but not the other application mediators 

S4: (VE.source==vcA) = = > (RE.major= <, set"RE.fireA) &8c 

(PE.major=PE.ADD PE.source=vcB PE.fire) && (VC.vcB.refresh(RE.dota)) 
if event source is vcA, then fire async request, then fire placement 
event, then refresh the newly placed view controller with the data 
returned with the request 

FIG. 1 02 
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10500 
writeObject(currentAttribute) 


Serialize 
10504 


BaseDota 


BaseSerializer 





currentAttribute.writeExternalQ 




serializer.writeObject(currentAttribute) 
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Externalizable 



SerializerIF 



10508 



10600 



Deserialize 



10602 
S 








10604 

s 


readObjectQ 






BaseDota 






BaseSerializer 





serializer.readObject() 




currentAttribute.reodExternal() 

FIG. 106 
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SerializerIF 



Externalizable 
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Access State machine to see if processing is needed 



10300- 
10302- 



C START ) 



ViewEvent 



Get ViewEvent.source 



10304 




10308- 



Locate table entries matching 
source/ViewEvent. major/ 
ViewEvent.minor tuple 



10310 




Locate table entries 
matching source/ 
ViewEvent.major pair 



C RETURN ) 



Use table entry(i) 



10318 



■10312 



Does toble 
entry(i) major = 
ViewEvent.major and/or 
entry(i). minor = 
^ViewEvent.minor 

9 ^10314 
I YES 



NO 



More 
action entries 
Jor entry^)?^ 

Iyes 



NO 



10316 
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10700 

package com.ibm.jtcx.serialization; 

import java.io.Externalizable; 

import java.io.IOException; 

import java.io.Objectlnput; 

import java.io.ObjectOutput; 

A* 

* Default type comment. 

* <P>INVARIANT: 
V 

public class BaseData implements Externalizable \ 
private 0bject[] data = null; 

A* 

* BaseData constructor comment. 

•/ 

public BaseData() \ 
this(O); 

A* 

* BaseData constructor comment. 

* ©param dataArray java.lang.Ob]ect[] 

•/ 

public BaseData(int count) \ 
super(); 

setData(new Object[count]); 

A* 

* Default method comment. 
* 

* <P>PRE: 

* <P>P0ST: 

* 

* ©return Parameter not modified 

* ©return java.lang.Object[] 
*/ 

public final Object[], getData() { 
return data; 



FIG. 107 A 
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10700 



A* 

♦ Defoult method comment. 
* 

* <P>PRE: 

♦ <P>P0ST: 

♦ ©return Porometer not modified 

* ©return java. long. Object 

* ©param index int 

•/ 

public final Object getDato(int index) { 
Object retVal = null; 



if ((date != null) && (index < data.length)) { 
retVol = dota[index]; 

return retVal; 



* Default method comment. 
* 

* <P>PRE: 

* <P>POST: 



* ©return Parameter not modified 

* ©param in Objectlnput 
*/ 

public void readExternal(ObjectInput in) 

throws ClossNotFoundException, lOException \ 

setData((Object[])in.readObject()); 

/•• 

* Default method comment. 

* <P>PRE: 

* <P>POST: 
♦ 

* ©return Parameter not modified 

* ©param dataArray java.lang.Object[] 
*/ 

public final void setData(Object[] dataArray) { 
data = dataArray; 



FIG. 107B 
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10700 



/•• 

* Defoult method comment. 
* 

* <P>PRE: 
» <P>P0ST: 

* 

* ©return Parameter not modified 

* ©param index int 

* ©param dataElement java.lang.Object 

public final void setData(int index, object dataElement) { 
if ((data != null) && (index < data.length)) { 
data[index] = dataElement; 



A* 

* Default method comment. 
* 

* <P>PRE: 

* <P>P0ST: 

* 

* ©return Parameter not modified 

* ©param out ObjectOutput 

•/ 

public void writeExternal(ObjectOutput out) throws lOException 
out.writeObject(getData()); 



FIG. 107C 
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10800 



pockoge com.ibm.jtcx.serializotion; 

jova.io.Externalizable; 
ava.io.lOException; 
ava.io.Objectlnput; 
ava.io.ObjectOutput; 
ava.math.BigDecimal; 
ava.math.Biglnteger; 



import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 



ova.uti 
ava.ut 
ava.ut 
ava.ut 
ovo.ut 
ava.ut 



Date; 
I.Enumeration; 
I.GregorianCalendar; 
I.Hashtable; 
I.SimpleTimeZone; 
UimeZone; 
I.Vector; 



import java.util 
/** 

* Base class of data objects that require small serialization. The 

* attributes of the data object are stored in an array and the elements 

* of the array are written individually. 
* 

* <P> INVARIANT: 
V 

public class BaseDataS extends BaseData implements Externalizable j 

/** 

* Default constructor. 

*/ 

public BoseDatoS() { 
super(); 

* Creates a new <code>BaseDataS</code> object with a data array of 

* size <code>count</code>. 
* 

* Oparam count the size of the data array containing the attributes 

•/ 

public BaseDotaS(int count) { 
super(count); 

FIG. 1 08A 
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* Reads the array of data elements from the stream. The responsibility 

* of reading the individual element is left to the 

* <code>BoseSerializer</code> via <code>readObject()<code>. 
♦ 

* ©param in the input stream that contains the serialized object 

* ©exception ClassNotFoundException thrown if 

* <code>BaseSerializer</code> fails to read the object from the stream 

* ©exception IOException thrown if 

* <code>BaseSerializer</code> fails to read the object from the stream 

* ©see BaseSerializer^readObject 

v 

public void readExternal(Objectlnput in) 

throws ClassNotFoundException, IOException j 

int size = in.readShort(); 

if (size = = -1) | 

setData(null); 

( else \ 

Object[] array = new Object[size]; 

for (int i = 0; i < size; i++) j 

array[i] = BaseSeriolizer.getInstance().readObject(in); 

setData(array); 



A* 

* Writes the array of data elements. The responsibility of writing the 

* data elements is left to <code>BaseSerializer</code> via 

* <code>writeObject()</code>. 

* ©parom out the output stream to which the data elements will be 

* written 

V 

public void writeExternal(ObjectOutput out) throws IOException \ 
Object[] array = getData(); 

if (array == null) j 

out.writeShort(-l); 

\ else | 

out.writeShort(array.length); 

for (int i = 0; i < array.length; i++) j 

BaseSerializer.getlnstanceO.writeObject^ut, array[i]); 



10800 

FIG. . 1 08B 
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10900 

package com.ibm.jtcx.serialization; 

import java.io.lOException; 
import jovo.io.Objectlnput; 
import java.io.ObjectOutput; 

A* 

* The interface for those classes that serialize objects to and from 

* a stream. The object that implements this interface should write 

* just the object's attributes, not any other descriptive information 

* about the object. Typically, a <code>SerializerlF</code> knows how 

* to serialize a specific class. 

*/ 

public interface SenahzerlF j 

/** 

* Reads an object from the stream. 
* 

* ©return The object that was read. 

* @param in the input stream containing the object 

* ©exception java.io.lOException thrown if the stream fails 

* ©exception java.lang.ClassNotFoundException thrown if the stream 

* fails 

•/ 

Object read0bject(0bjectlnput in) throws lOException, ClassNotFoundException; 
/•* 

* Writes the given object to the stream. 
* 

* ©param out the output stream into which the object will be written 

* ©param element the object that will be written to the stream 

* ©exception java.io.lOException thrown if the stream fails 

•/ 

void writeObject(ObjectOutput out, Object element) throws lOException; 
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pockage com.ibm.jtcx.seriolizotion; 



impor 
impor 
impor! 
imporl 
impor 
impor 
impor 
impor 
imporl 
impor 

/ 



java.io.*; 

jovo.moth.Biglnteger; 

java.math.BigDecimol; 

jovo.util.Dote; 

jovo.util.GregorionColendor; 

jova.util.Hashtoble; 

jovo.util.SimpIeTimeZone; 

javo.util.StringTokenizer; 

jovo.util.TimeZone; 

javo.util.Vector; 



The <code>SeriolizerlF</code> that is used os the base level 1 
serializer. It contains three tobies used to serialize objects: 
<br><ul> 

<li> codeTable: the table containing the serialization code of 

an object based on the name of the class 
<li> nameTable: the table containing the name of the class 

based on the serialization code 
<li> serializationTable: the table containing the serializer of 
an object based on its serialization code 

</ul> 
<br><br> 

<code>BaseSerializer</code> delegates the responsibility of 
serializing the objects to the <code>SerializerlF</code> associated 
with that class or to the object itself if it implements 
<code>Externalizable</code>. 

/ . • c 

public class BaseSerializer implements SerializerIF } 
static private final int NULLOBJECT = 0; 
static private final int OTHER = OxOOff; 

static private final String HASHTABLE_SER = "ClassNameHash.ser"; 
static private final String INLFILE = "ClassNames.ini"; 

static private Hashtable codeTable = null; 

static private Hashtable nameTable = null; 

static private Hashtable serializerTable = null; 

static private BaseSerializer instance = null; 

class BigDecimalSerializer implements Serializer IF { 

public Object read0bject(0bjectlnput in) throws ClassNotFoundException, lOException | 
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int scale = in.reodShort(); 
int size = in.reodShort(); 
byte[] bytes = new byte[size]; 
in.readFully(bytes); 

Biglnteger temp = new Biglnteger(bytes); 
return new BigDecimal(temp, scale); 

public void writeObject(ObjectOutput out, Object element) throws lOException { 
BigDecimal bigD = (BigDecimal)element; 

int scale = biqD.scale(); 
bigD.setScale(O); 



class Big I n teg erSeria lizer implements SerializerIF j 

public Object readObject (Object Input in) throws ClassNotFoundException, lOException 

int size = in.readShort(); 
byte[] bytes = new byte[size]; 
in.readFully(bytes); 

return new Biglnteger(bytes); 

public void write0bject(0bject0utput out, Object element) throws lOException { 
byte[] bytes = ((Biglnteger)element).toByteArray(); 

out.writeShort(bytes.length); 
out.write(bytes); 

closs BooleanSerializer implements SerializerIF } 

public Object reod0bject(0bjectlnput in) throws ClassNotFoundException, lOException 

int value = in.reodByte(); 

return (value == 1) ? Boolean.TRUE: Booleon.FALSE; 

public void write0bject(0bject0utput out, Object element) throws lOException { 
out.writeByte(((Boolean)element).booleonValue() ? 1 : 0); 




out.writeShortfscale); 

out.writeShort(bytes.length); 

out.write(bytes); 
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closs ByteSeriolizer implements SeriolizerIF { 

public Object reodObject(Object Input in) throws ClossNotFoundException, lOException { 
byte value = in.readByte(); 

return new Byte(value); 

public void writeObject(ObjectOutput out, Object element) throws lOException J 
out.writeByte(((Byte)element).byteValue()); 

closs CharocterSerializer implements SeriolizerIF j 

public Object read0bject(0bjectlnput in) throws ClossNotFoundException, lOException j 
char value = in.readCharQ; 

return new Character(value); 

public void write0bject(0bject0utput out, Object element) throws lOException \ 
out.writeChar(((Character)element).charValue()); 

. f 

class DateSerializer implements SeriolizerIF \ 

public Object read0bject(0bjectlnput in) throws ClossNotFoundException lOException { 
long value = in.readl_ong(); 

return new Date(value); 

public void writeObject(ObjectOutput out, Object element) throws lOException j 
out.writeLong(((Date)element).getTimeQ); 

class DoubleSerializer implements SeriolizerIF j 

public Object reod0bject(0bjectlnput in) throws ClossNotFoundException, lOException { 
double value = in.readDouble(); 

return new Double(value); 

public void writeObject(ObjectOutput out, Object element) throws lOException J 
out.writeDouble(((Double)element).doubleValue()); 
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closs FlootSerializer implements SerializerIF j 

public Object read0bject(0bjectlnput in) throws ClassNotFoundException, lOException j 
float value = in.readFloat(); 

return new Float(value); 

public void write0bject(0bject0utput out, Object element) throws lOException | 
out.writeFloat(((Float)element).flootValue()); 



class GregorianCalendarSerializer implements SerializerIF { 

public Object read0bject(0bjectlnput in) throws ClossNotFoundException ( lOException j 
long time = in.readLonqQ; 
Date date = new Dateftime); 
SerializerIF serializer = BaseSerializer.getlnstanceQ; 
TimeZone tz = (TimeZone)serializer.readObject(in); 

GregorianCalender gCalender = new GregorianCalendar(tz); 
gCalendar.setTime(date); 

return gCalendar; 

public void writeObject(ObjectOutput out, Object element) throws lOException j 
GregorianCalendar temp = (GregorianCalendar)element; 

Date dote = temp.getTime(); 
TimeZone tz = temp.getTimeZone(); 

out.writeLong(date.getTime()); 

SerializerIF serializer = BoseSeriolizer.getlnstanceQ; 

serializer.writeObject(out, tz); 

class IntegerSerializer implements SerializerIF | 

public Object read0bject(0bjectlnput in) throws ClassNotFoundException, lOException { 
int value = in.readlnt(); 

return new Integer(value); 

public void write0bject(0bject0utput out, Object element) throws lOException j 
out.writelnt(((lnteger)element).intValue()); 

class LongSerializer implements SerializerIF j 

public Object readOb ject(0bject Input in) throws ClassNotFoundException, lOException { 
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long value = in.reodLongQ; 



return new Long(value); 

public void writeObject(ObjectOutput out, Object element) throws .lOException { 
out.writeLong(((Long)element).longVolue()); 

class ObjectArraySerializer implements SerializerIF { 

public Object read0bject(0bjectlnput in) throws ClassNotFoundException, lOException j 
int size = in.readShort(); 

Object[] array = new Object[size]; 
for (int i = 0; i < size; i++) \ 

SerializerIF serializer = BaseSerializer.getlnstance(); 

array[i] = serializer.readObject(in); 



return array; 

public void writeObject(ObjectOutput out, Object element) throws lOException j 



class ObjectSerializer implements SerializerIF i 

public Object readObject(Objectlnput in) throws ClassNotFoundException, lOException { 
return in.readObject(); 

public void writeObject(ObjectOutput out, Object element) throws lOException { 



class ShortSerializer implements SerializerIF | 

public Object read0bject(0bjectlnput in) throws ClassNotFoundException, lOException | 
short value = in.readShortQ; 




out.writeShort(array.length); 

for (int i = 0; i < array length, i++) j 

SerializerIF serializer = BaseSerializer.getlnstanceQ; 

serializer.writeObject(out, orray[i]; 



out.writeObject(element); 



return new Short(value); 
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public void writeObject(ObjectOutput out, Object element) throws lOException { 
out.writeShort(((Short)element).shortVolue()); 

i 1 . t 

closs SimpleTimeZoneSeriolizer implements SeriolizerIF | 

public Object reodObject(Objectlnput in) throws ClassNotFoundException, lOException \ 
int offset = in.readlnt(); 

SeriolizerIF serializer = BaseSerializer.getlnstanceQ; 
String id = (String)seriolizer.reodObject(in); 

return new SimpleTimeZone(offset ( id); 

public void writeObject(ObjectOutput out, Object element) throws lOException { 
SimpleTimeZone temp = (SimpleTimeZone)element; 

out.writelnt(temp.getRawOffsetQ); 

SeriolizerIF serializer = BaseSerializer.getInstance(); 

serializer.writeObjectCout, temp.getlDQ); 



class StringSerializer implements SeriolizerIF \ 

public Object read0bject(0bjectlnput in) throws ClassNotFoundException, lOException J 
int size = in.readShortQ; 
byte[] bytes = new byte[size]; 
in.readFully(bytes); 

return new String(bytes); 

public void writeObjectfObjectOutput out, Object element) throws lOException { 
byte[] bytes = ((String)element).getBytesQ; 

out.writeShort(bytes.length); 
out.write(bytes); 

i 1 

class VectorSerializer implements SeriolizerIF | 

public Object recd0bject(0bjectlnput in) throws ClassNotFoundException, lOException \ 
int size = in.readShortQ; 

Vector vector = new Vector(size); 
for (int i = 0; i < size; i++) | 

SeriolizerIF serializer = BaseSerializer.getlnstanceQ; 

vector.oddElement(serializer.readObject(in)); 

i 
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return vector; 

public void writeObject(ObjectOutput out, Object element) throws lOException 
Vector temp = (Vector)element; 

0bject[] array = new Object[temp.sizeQ]; 
for (int i = 0; i < array.length; i++) j 
arroy[i] = temp.elementAt(i); 

i 

out.writeShort(array.length); 

for (int i = 0; i < array.length; i++) | 

SerializerIF serializer=BaseSeriolizer.getInstance(); 

serializer.writeObject(out, array[i]); 

* Default constructor. The constructor is private because this is a 

* singleton class. When the object is constructed, it initializes its 

* tables. 

V 

private BoseSerializer() { 
init(); 

u 

* Adds the given elements to the three tables. 
* 

* ©param className the name of the class 

* ©pgram code the code for the given class 

* ©param serializer the object responsible for serializing the given 

* class 

private void addDataToTabIes(String className, Number code, SerializerIF serializer) j 
getCodeTable().put(code, className); 
getNameTable().put(className, code); 

if (serializer != null) { 

getSerializerTable().put(code, serializer); 

1 FIG. 11 OG 
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* Creates the codes and seriolizer objects for the default serialization 

* classes and adds them to the tables. The tables are then written to 

* a serialized file. 

*/ 

private void createDefaultTables() \ 

addDataToTables(BigDecimal.class.getName() l new Byte((byte)1), new 
BigDecimalSerializerQ); 

addDataToTables(Biglnteger.class.getNameQ, new Byte((byte)2), new BiglntegerSerializerQV 

addDataToTablesfBoolean.class.getNameO, new Bvte((byte)3), new BooleanSerializerQ); 

addDataToTables(Byte.class.getName(), new Byte((byte)4), new ByteSerializer()); 

addDataToTablesfCharacter.class.getNameO, new Byte((byte)5), new CharacterSerializer()); 

addDataToTablesfDate.class.getNameO, new Byte((byte)6), new DateSerializerQ); 

addDataToTables(Double.class.getName(), new Byte((byte)7), new DoubleSerializer()); 

addDataToTables(Float.class.getName(), new Byte((byte)8), new FloatSerializer()); 

addDataToTablesfGreqorianCalendar.closs.getNameO, new Byte((byte)9), new 
GregorianCalendarSerializerQ; 

addDataToTablesflnteger.class.getNameO, new Byte((byte)10), new lntegerSerializer()); 

addDataToTablesiLong.class.getNameQ, new Byte((byte)1 1), new LongSerializer()); 

addDataToTablesiShort.class.getNameQ, new Byte((byte)12), new ShortSerializer()); 

addDataToTables(SimpIeTimeZone.class.getName(), new Byte((byte)13), new 
SimpleTimeZoneSerializer()); 

addDataToTablesfString.class.getNameQ, new Byte((byte)14), new StringSerializer()V 

addDataToTableslVector.class.getNameQ, new Byte((byte)15), new VectorSerializerfn; 

addDataToTables^Object.class.getNameO, new Byte((byte)16) l new ObjectSeriolizerQ); 

writeTables(); 



* Returns an instance of the table of class names, keyed by their code. 

* If the table does not exist, it is created. 

* ©return The table of class names. 

protected Hashtable getCodeTable() { 
if (codeTable == null) { 

codeTable = new Hashtable(); 
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return codeToble; 

i 

/" 

* Returns on instance of <code>BoseSeriolizer</code>. 
* 

* ©return An instance of <code>BaseSerializer</code>. 

V 

public static SerializerIF getlnstance() { 
if (instonce == null) { 

instance = new BaseSerializer(); 

i 

return instance; 

\- 

* Returns an instance of the table of codes, keyed by their 

* corresponding class name. 

* If the table does not exist, it is created. 
* 

* ©return The table of codes. 

*/ 

protected Hashtable getNameTable() \ 
if (nameTable == null) \ 

nameTable = new Hashtable(); 

i 

return nameTable; 

\- 

* Returns an instance of the table of serializers, keyed by their 

* corresponding code. 

* If the table does not exist, it is created. 

* @ return The table of class names. 

protected Hashtable getSeriolizerTable() j 
if (serializerTable == null) { 

serializerTable = new Hashtable(); 

i 

return serializerTable; 

* Initializes the hashtable from either a serialized hashtable or from 

* an ini file. 

* 7 FIG. 1 1 01 



108/119 
AUS990339US5 



11000 

protected void init() j 

File seriolizedFile = new File(HASHTABLE_SER); 
File iniFile = new File(INLFILE); 

if (serializedFile.exists()) { 

readSerializedFile(serializedFile); 

\ else { 

if (iniFile.exists()) { 

readlniFile(iniFile); 

i 



createDefoultTables(); 

I 



* Gets the value of the serialization code from the table based on 

* the className provided. The value returned can either be a 

* <code>Byte</code> or an <code>lnteger</code>. The return value 

* will be a <code>Byte</code> if the className is one of the base 

* data types. 
♦ 

* ©return The serialization code of the className. 

* ©param className the name of the class 

private Number lookupCode(String className) j 
Number code = null; 

if (className != null) | 

code = (Number)getNameTableQ.get(className); 



return code; 



** 



* Looks up the hashcode in the table and returns the String value of 

* the hashcode. If the hashcode does not exist in the table 

* <code>null</code> is returned. 
* 

* ©return The object thot was stored in the table with the given 

* hashcode. 

* ©param hashcode the hashcode that will be used to look up the value 

FIG. 1 1 0J 



109/119 
AUS990339US5 



11000 

private String lookupName(Number code) j 
String clossName = null; 

if (code != null) { 

clossName = (String)getCodeTable().get(code); 

return clossName; 

* •Default method comment. 
* 

* <P>PRE: 

* <P>P0ST: 
* 

* ©return Parameter not modified 

* ©return com.ibm.jtc.util.SerializerIF 

* ©param code int 

*/ , 

private SerializerIF lookupSeriolizer(Number code) \ 
SeriolizerIF serializer = null; 

if (code != null) \ 

serializer = (SerializerlF)getSerializerTable().get(code); 

return serializer; 

* Default method comment. 
* 

* <P>PRE: 

* <P>POST: 

* 

* ©return Parameter not modified 

* ©param iniFile java.io.File 

*/ , 

private void readIniFile(File iniFile) { 
BufferedReader in = null; 

try j 

in = new BufferedReoder(new FileReoder(iniFile)); 

for (String inLine = in.readLine(); inLine != null; inLine = in.readLine()) j 
String trimLine = inLine.trim(); 
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if ((trimLine.iength() > 0) &8c 

!trimLine.stQrtsWith( ,l | ,, )) { 

StringTokenizer tokenizer = new StringTokenizer(trimLine); 

String clossNome = tokenizer.nextToken(); 

Integer code = new Integer(classNome.hoshCode()); 

Serialized F serializer = null; 

if (tokenizer.hosMoreTokens()) j 

String serializerName = tokenizer.nextToken(); 

try { 

serializer = (Serializerir)Closs.forName(seriolizerName).newlnstance(); 
( catch(Exception e) { } 

addDataToTables(className, code, serializer); 

| catch (Exception throwAway) } 
{ finally : 
try j 

in.close(); 
| catch (Exception throwAway) { 

i 

writeTables(); 

/** 

* Reads the object from the stream by first reading the code for the 

* element then reads the appropriate data for that object. 
* 

* ©return The object that was read from the stream. 

* ©param in the input stream that contains the object 
*/ 

public Object readObject(Objectlnput in) 

throws ClassNotFoundException, lOException { 
Object retVal = null; 
Number code = null; 

byte baseCode = in.readByte(); 
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if (boseCode == NULLOBJECT) | 
retVol = null; 

| else { 

if (boseCode != OTHER) \ 

code = new Byte(boseCode); 

j else { 

int secondCode = in.reodInt(); 
code = new Integer(secondCode); 

SeriolizerIF seriolizer = lookupSerializer(code); 
if (seriolizer != null) j 

retVal = seriolizer.reodObject(in); 

( else { 

String className = lookupNome(code); 
try \ 

retVol = Class.forNome(clossNome).newlnstonce(); 

if (retVol instonceof Externalizoble) { 

((Externalizable)retVal).reodExternol(in); 

| else j 

retVal = in.reodObjectQ; 
| catch(Exception e) \ 

« ■ 

return retVal; 

* Reods the file containing the serialized hoshtobles of data. 
* 

* ©param serializedFile the file containing the serialized tobies 

private void readSerializedFile(File serializedFile) j 
ObjectlnputStream in = null; 
try { 

in = new ObjectInputStream(new FilelnputStreom(serializedFile)); 
codeTable = (Hashtable)in.readObject(); 
nameTable = (Hashtable)in.readObjectQ; 
serializerTable = (Hashtable)in.readObject(); 
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catch (Exception throwAwoy) ( 
finally ) 

try 1 . 

in.close(); 
| catch (Exception throwAwoy) J j 

if ((codeTable == null) |( 

fnameTable == null) || 
(serializerTable == null)) j 



i 



createDefaultTablesQ; 



* Writes the given object to the stream. First, the code representing 

* the type of the object is written, then the data within the object 

* is written. 
* 

* @param out the output stream that will contain the object 

* ©param element the data object that will be written 

public void writeObject(ObjectOutput out, Object element) 
throws lOException \ 

if (element == null) { 

out.writeByte(NULL_OBJECT); 

j else \ 

String className = element.getClass().getName(); 
Number code = lookupCode(className); 

if (code != null) { 

if (code instanceof Byte) \ 

out.writeByte(code.byteValue()); 
| else if (code instanceof Integer) j 
out.writeByte(OTHER); 
out.writeInt(code.intValue()); 

i 

SeriolizerIF serializer = lookupSerializer(code); 

if (serializer != null) | 

serializer.writeObject(out, element); 
j else if (element instanceof Externalizable) { 

((Externalizable)element).writeExternal(out); 
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| else { 

out.writeObject(element); 

| else | 

if (element instonceof Objectf]) \ 

clossNome = Object[].class.getNome(); 

( else { 

clossName = Object.class.getNome(); 

code = lookupCode(clossNome); 

SeriolizerIF seriolizer = lookupSeriolizer(code); 

out.writeByte(code.byteValue()); 
seriolizer.writeObject(out, element); 



* Writes the tables to the file. 

v 

private void writeTablesQ { 

ObjectOutputStream out = null; 

try | 

File serFile = new File(HASHTABLE_ SER); 

out = new ObjectOutputStream(new FileOutputStream(serFile)); 

out.writeObjectfgetCodeTable()); 

out.writeObject(getNameToble()); 

out.writeObjectfgetSeriolizerTobleO); 

out.writeObject(new Date()); 
\ cotch(Exception e) { 
( finally j 

try | 

out.close(); 
( catch(Exception e) j | 
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